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Introduction 





elcome to the Beginners guide to Adventure Game Studio (created by Chris Jones). AGS 
allows you to create your own point-and-click adventure games, similar to the early 90's 
Sierra and Lucasarts adventures like Monkey Island, Beneath A Steel Sky, Zak McKracken 



and King's Quest . It consists of an easy-to-use editor to create your games, and a run-time engine to 
play them. 

The game interface is fully customizable, with classic Sierra and Verb Coin templates provided by 
default. AGS manages most of the game so that you don't have to - it does all the donkey work like 
load/save game functions, pathfinding and scrolling rooms so that you can concentrate on the parts 
of your game that make it unique. 

Set up your rooms, characters and sprites visually in the editor, then add some script to handle game 
events and you're done! You can even create a standalone EXE file containing your entire game, 
which you can then distribute to your adoring fans worldwide. 

I'd like to thank everyone on the Adventure Game Studio Forum for their time and effort in helping 
compile this guide, without their help this would have gone nowhere. I've only personally written 
the stuff that has my name on it, everything else was done by the Forum community members for 
which they have my eternal thanks. 

Special thanks go to the following people, whose knowledge of AGS has helped others, including 
myself and whose numerous answers are included in this guide: 

KhrisMUC, Ghost, Trent R, Dualnames, monkey_05_06 

Also, check out the FAQ blog here created by Dualnames which provides an excellent online 
resource. 
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LucasArts Style Dialogue Tutorial 

By Nickydude 

Here is a simple Monkey Island style dialogue tutorial that will help those who don't quite grasp how 
to do it and what you can do to make a small dialogue 'cutscene'. The way it works is that there will 
be a list of dialogue lines you can choose from and replies will depend on which line you choose. 

In order to create a dialog (/'// use this way of spelling it from now on instead of 'dialogue '(I'm from 
the UK) as that is how AGS needs the spelling to be) you'll need characters to speak to (obviously) so 
I'm assuming here that you have the player character called, cGuyBrush for example and you've 
created another one, let's say you created a character called 'cOldMan' 

Double click on the Dialogs in the treeview on the right and it will display a dialog called 0: dDialogO 



New game - AGS Editor 



SUE 



File 



Build Help 

II4T ® 



Char: cOldMan 



Start Page 



ft® 



Adventure Game Studi 



Welcome to AGS! 

If this is your first time with 
AGS, be sure to read the 
Tutorial to get you started. 

The tree in the top-right is the 
main way you'll be navigating 
around the editor. 



Did you know? 

Use the T key to quickly flip 
frames in the view editor. 

Show another tip 



What's new in AGS 

AGS 3.1 brings 
several new 
features to your 
game-making 
experience! 

If you've come 
from AGS 2.72, 
read this page in 
the manual to get 
up to speed with 
the new AGS 3 
editor. 

If you were using 
AGS 3.0.2, read 
this page which 
tells you the main 
breaking changes 
in AGS 3.1. 

^nmp nf t"hp np>.v 
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GUIs 

Inventory items 
Dialogs 

Views 
Characters 
Mouse cursors 
Fonts 

Global variables 
Scripts 
Plugins 
Rooms 
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Double click on dDialogO and you'll get the dialog editor screen, like so: 



1 ■ New game - AGS Editor 






File Build Help 


i £ 0 i ® 






Dialog: dDialogO [ Char:cOldMan 


Start Page 


ft® 



Option text: 



Create new option 



// Dialog script file 
Show Say g s // Dialog startup entry point 
return 



Now we need to think about how the dialogue will go. First make a list of everything the player will 
first say to the character they're talking too, for example: 

HI, my names Nick. 
Who are you? 

That's a nice hat you're wearing. 
What do you think of AGS? 
Sorry to bother you. 

When you have created your list, click on the Create new option button and an input box will appear 
(see image on next page) ready for you to type in your first line, also, on the right you'll see a 
notepad like edit area and when you clicked the Create new option button, a @l - return will have 
appeared, it's here that you'll add all the replies. If you click the Create new option button again 
another input box will appear and a @2- return will be added and so on. We'll delve more into the 
Dialog script file in a moment. 
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1 • New game - AGS Editor 




□E 


File Build Help 


: s n # ® 








Dialog: d Dialog 0 


ChancOldMan 


Start Page 


ft® 



Option text: 



i, mv names Nick. 



Show Say 
0 0 



Create new option 



Delete last option 



// Dialog script file 

@S // Dialog startup entry point 

return 

@1 

return 



< 



Type into the first input box the first line of dialog (see above), then click the Create new option 
button and add the next line, keep going till you've added all your dialogue (ignore the Show & Say 
checkboxes, we'll get to those later): 



Char: cGuyBrush 



Dialog: dDialogO Start Page 



Option text: 



1: 
2: 
3: 
4: 
5: 



Hi, my names Nick. 



Who are you? 



That's a nice hat you're wearing. 



What do you think of AGS? 



Sorry to bother you. 



Create new option 



Delete last option 



Show 


Say 


0 


0 


0 


0 


0 


0 


0 


0 


0 


0 



In the notepad area on the right, you'll see something like this: 
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// Dialog script file 

@S // Dialog startup entry point 

return 

81 

return 
02 

return 
@3 

return 
04 

return 



This is the dialog script and it's here that you'll add your replies. So now we need to make up some 
replies (the italics are just to show what the reply will be too): 

HI, my names Nick. 
Glad to hear it. 
Who are you? 

I'm the old lookout from Monkey Island, remember me? 

That's a nice hat you're wearing. 

Thanks, I have one for you if you want one. 

What do you think of AGS? 

AGS? Is that some sort of hip replacement treatment? 
Sorry to bother you. 
That's quite alright sonny. 

Now we need to put these into the Dialog script in order for the OldMan to reply. 

-ooOoo- 

Dialog Script File 

It's here that we'll put our replies, as well as other scripting commands that you can use, for example 
to move the player to a specific area, to face a specific area, the player can receive an item, give an 
item and a whole host of other stuff. Firstly we'll just have the old man reply. 
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The first thing you'll see at the top of the Dialog script is this: 

// Dialog script file 

@S // Dialog startup entry point 

return 



Change it to look like this: 

// Dialog script file 

@S // Dialog startup entry point 

GuyBrush: Wonder if he knows something. 

return 

Anything between the @S and return will always show immediately before the list of dialog is 
displayed, so every time you speak to the old man, the player will say "Wonder if he knows 
something." Then the list of dialog options will be displayed. 

Note that Player is the name of the character talking, Guybrush:, also note that it's the name of the 
character talking without the prefix, in this case 'c'. Say you called your character cNikAnderson, 
then it would be: 

// Dialog script file 

@S // Dialog startup entry point 

NikAnderson : Wonder if he knows something. 

return 

Now we'll add our first reply and we need to add it between @1 and return. The @1 means that this 
is the first reply and the return is essential, because it tells AGS not to automatically move to the 
next reply and display it. 

@1 // First reply 
// HI, my names Nick 
OldMan: Glad to hear it. 
return 

The game engine ignores lines beginning with '//', these are just comments to help you remember 
what does what. 

On to the next reply: 

@2 // Second reply 
/ / Who are you? 

OldMan: I'm the old lookout from Monkey Island, remember me? 
return 



Now fill in the rest any your script should look something like the one over the page. 
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// Dialog script file 

@S // Dialog startup entry point 

GuyBrush: Wonder if he knows something. 

return 

ei 

OldMan: Glad to hear it. 

return 

@2 

OldMan: I'm the old lookout from Monkey Island, remember me? 

return 

@3 

OldMan: Thanks, I have one for you if you want one. 

return 

84 

OldMan: AGS? Is that 3ome sort of hip replacement treatment? 

return 

@5 

OldMan: That' 3 quite alright sonny 

3t0p 



So for each of the player's line of dialog (in the input boxes), the OldMan will reply. Notice the word 
stop right at the end, this tells the engine that the dialog is finished and return back to the game. 

Ok, we have the dialog but there a few things to take care of before we can use it. 

-00O00- 

Bits & Pieces 

Beside each input box there are two checkboxes; Show & Say. The Show checkbox tells the engine 
whether or not to show the dialog in the list, for example unticking Show next to the line "That's a 
nice hat you're wearing" will not show that line of dialog: 

HI, my names Nick. 
Who are you? 
What do you think of AGS? 
Sorry to bother you. 

This allows you to hide certain dialog until specific things have happened, for example the old man 
might not have a hat until you give him one, then you can turn on that dialog line. 

Say determines whether that dialog line will appear as speech above the head after you've selected 
the dialog line. It's also best to rename your dialog from the default dDialogO in this case to 
dOldMan so you'll know exactly which dialog it is. 

All that's left to do now is active the dialog. Select the cOldMan character (in this example) and click 
on the Events button (looks like lightning, see over) 
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linn] 



EES 



File Build 



Help 

® 



Char: cOldMan 



"5]® 



Selected character settings 
This character is not the player character. 



Make this the player character 



Normal view 
Loop: 



Frame: 



Delay: 



0 






0 


A. 







0 Character view (centre pivot) 
Animate 

l~~l Skip frame 0 (standing frame) 



O Lip sync 

+ EE guis 

IB ^ Inventory items 
B Dialogs 

: Cp 0: dDialogO 
12 oi views 
3 *fl Characters 

f 0: cGuyBrush 
*fl L cOldMan 
IB ^ Mouse cursors 
Si A B Fonts 



cOldMan (Character 1) 



in -/ 



□ Events 

Any dick on character 
Interact character 
Look at character 
Pick up character 



Talk to character 



I lip invpntnrv nn rtw? 



Talk to character 



V 



Q 



Now click on the ellipses button next to Talk to character to bring up the function in the room script 

function c01dMan_Talk ( ) 

{ 

} 

Inside this function you'll need the name of the dialog, dOldMan, and you need to tell the function 
to 'start' the dialog with .Start{); 

function c01dMan_Talk ( ) 

{ 

dOldMan. Start () ; 



And there you have it, using the Sierra style interface (clicking the right mouse button to cycle to the 
speech icon) and clicking on the 'OldMan' the dialog will begin (see over). 
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Ok, we have our dialog, which is great but there are a few things we can do to make it better. At the 
moment the player asks a line of dialog, the old man answers and that's it, the dialog list will display 
again with the same player dialog lines. But what happens if you ask the old man something, like 
"Where's Alan?" (This is from a game I'm creating) and the old man (called 'BillGates' here) replies 
"He's in the night club." You now might what the dialog choices to be about the night club, in affect 
the dialog has switched to something else. Here's the dialog from my game, between GuyBrush and 
BillGates (the bold italic lines are the lines of dialog BillGates is replying to) : 

// Dialog script file 

@S // Dialog startup entry point 

GuyBrush: Hi 

BillGates: Hello. 

return 

@1 

/ / Hi, my name ' s Guybrush 

BillGates: Is it really? I used to know a GuyBrush once. 

BillGates: Used to live on Monkey Island... 

BillGates: Wanted to be a pirate... 

BillGates: Wonder what became of that poor chap... 

return 

@2 

/ / Who are you ? 

BillGates: Who am I? 
BillGates: I'm Bill Gates. 
GuyBrush: What? 

BillGates: Bill Gates, the founder of Microsoft. 

GuyBrush: What are you doing here? I thought you were retired? 

BillGates: I didn't want to retire, they retired me. 

BillGates: It all started when they said they wanted to update the 

operating system. 

BillGates: They came to me with this buggy piece of software... 
BillGates: I told them it was no good and to start again... 
BillGates: and before you could say 'Vista' they retired me. 
BillGates: Blindfolded me and took me to this island. 

BillGates: and now I spend each day seeing if they'll come back for me. 

GuyBrush: Don't worry, I'm sure they'll come back for you. 

BillGates: I hope not the ****ers. I have my cannon ready to sink the 

****ers if they come anywhere near here! 

Guybrush: Err., ok then. 

return 

@3 

// Do you know where Alan is? 

BillGates: Alan? 

GuyBrush: Yes, Alan. 

BillGates: Alan you say? 

GuyBrush: Yes, Alan... Alan Bell? 

BillGates : Alan . . . 

BillGates : Alan . . . 

BillGates: Ahh, A-l-a-n. 

BillGates: You'll probably find him in the night club, only VIP's are 
allowed in there though, 
goto-dialog dNightClub 
@4 

// Sorry to bother you. 

BillGates: That's quite alright sonny. 
Stop 
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The first thing you'll probably notice is that there are a number of replies for each question asked 
instead of just the one line reply that we previously had. Each line means that line will be displayed 
as speech, disappear and the next line will appear as speech, this way you can have a long reply as 
each line will be displayed one after the other, also you can mix character replies and that particular 
line will appear above that particular characters head: 

BillGates: Who am I? 
BillGates: I'm Bill Gates. 
GuyBrush: What? 



First, Who am I? will appear above BillGates head for a short while, then disappear and be replaced 
by I'm Bill Gates. Then that will disappear and What? will appear over GuyBrush's head. This allows 
you to have conversation back and forth without having to select dialog lines every time. 

If you look at the dialog for Do you know where Alan is? You will see that instead of return at the 
end of the dialog, it say's goto-dialog dNightClub. The goto-dialog command means just that, leave 
this dialog and start another one. This way, you can display another set of dialog lines for a specific 
thing. In this example, the player asks: 

Do you know where Alan is? 

BillGates replies: 
He's in the night club. 

The game then sees the command goto-dialog dNightClub and thinks "ahh, now display the dialog 
that's been created in another dialog called dNightClub"). Here's the new dNightClub dialog. 



Dialog: dNightClub Dialog: dBillGatesStart | Start Page 



■a® 



Option text: 



Where is this night dub? 



Horn do I get in? 



Why would alan be there? 



Thanks for the help. 



Create new option 



Delete last option 



0 
0 
0 
0 



Say 

0 
0 
0 
0 



// Dialog script file * 

8S // Dialog startup entry point 

return 

@1 

// Where is this night club? 

3illGates: You can't miss it. Club Nitro it 

3illGates: Full of young people. 

BillGates: Apparently it's fancy dress nigh 

GuyBrush: Don't tell rae. . . 

GuyBrush: . . .Pirates. . . 

BillGates: Yes, how did you know? 

Suy3ru3r.: Just a wild . 

return 

02 

// How do I get in? 

3illGates: Lilce I said only VIF's are allow 
3illGates: You'll need to prove you're a VI 
Wait (40) ; 

3illGates : You've got your work cut out the 
cGuyBrush. FaceLocation (296, 252,eBlock) ; 
Wait (80) ; 

cGuyBrush. FaceLocation (213, 147, eBlock) ; 
Guy3rush: Humph. . . Thanks, 
return 
83 



General Settings 
& Colours 
»? Sprites 
nbj Text Parser 
4» Lip sync 

i EE guis 

ii ^ Inventory items 
- Dialogs 

<iJ 0: dMGatesStart 
<p 1: dNightClub 

m W Views 

i±l fft Characters 



dNightClub (Dialog 1) 



m 



B Appearance 

ShowTextPai False 
B Design 



Name 



dtlightClub 



ID 

The ID number of the dialog 



And over the page is the sort of thing you would get. 
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My name's Guybrush 
Who are you? 

Do you know where Rlan is? 
Sorry to bother yc%. 



Questions & Answers 



Q: I HAVE A CHARACTER SAYING "EMPTY POTS." WHICH IS OBVIOUSLY A SHORT SPEECH. HOW CAN I KEEP THE 
SPEECH TEXT ON SCREEN FOR LONGER? IS THERE AN EQUIVALENT OF SOMETHING LIKE "SPEECHDlSPLAYSPEED="? 

A: Use game.text_speed. Make sure it's all lowercase. Example: 

function hPots Look() 

{ 

game . text_speed = 10; // Slow down the length of time speech stays on 
screen 

cEgo . Walk ( 37 5 , 315, eBlock, eWalkableAreas ) ; 
cEgo . Say ( "Empty pots."); 

game . text_speed = 15; // Back to default speed 

} 



Q: I HAVE A BIT OF A PROBLEM WITH THE WALKABLE BASELINE. TAKE A LOOK AT THIS IMAGE 




When the player enters the door he goes behind like he should... 




but when he gets near the outside of the wall, he disappears (because of where the baseline is set)... 
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How would I get around this problem? 

A: Either use two walkable areas or add a region and use that to determine whether he's inside the 
building or not. Regardless, inside the room's repeatedly_execute, set the walkbehind's baseline to 1 
(player isn't behind it) or the actual Y-coord. 

Q: I HAVE AN OBJECT THAT THE CHARACTER WALKS TO TO 'LOOK' AND SEE WHAT IT IS AND I USE THE FOLLOWING 
CODE 

function hPillow Look() 

{ 

cEgo.Walk(104, 160, eBlock, eWalkableAreas ) ; 
cEgo . Say ( "Looks like a comfy pillow to me.") ; 

} 

This works fine, he walks to the object to see what it is. At the moment the player can't do anything 
with the character till he's gone over to the object and looked at it, I'd like to be able to have the 
character change direction if the player clicks somewhere else, on the way to the object. I changed 
eBlock to eNoBlock but then the character doesn't walk to the object and just says what it is from 
where ever position he is in the room. 

Basically I'd like the character to walk to an object if it's to be looked at, but be able to divert him 
somewhere else if need be as he's going towards the object. 

A: 

Q: I WANT THE MAIN CHARACTER TO LOOK AT A HOTSPOT FROM ITS POSITION. ANYONE KNOW HOW TO DO THIS? 

A: You can use Character.FaceLocation(int x, int y) and insert the coordinates of the hotspot. Also If 
you want the character to look in the direction of whatever he's looking at, you can also just add a 
FaceLocation(mouse.x,mouse.y) call in the look interaction. 
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Q: I WOULD LIKE TO KNOW HOW I COULD MAKE IT SO THAT ONCE MY CHARACTER HAS STEPPED ON THIS REGION 
ONCE AND THE DIALOG HAS HAPPENED HOW I COULD MAKE IT SO THAT THIS NEVER HAPPENS AGAIN WHEN I STEP ON 
THE REGION. 

A: Use variables. 

On the top of the room's script: 

int steppedonregionl=0 ; 

Then change your region code to: 

function regionl WalksOnto ( ) 

{ 

if ( steppedonregionl==0 ) [ 

cGloriana.Say ("HELP, HELP!"); 

cGloriana. Say ("CAN SOMEONE PLEASE HELP!"); 

steppedonregionl=l ; 

} 

} 

Alternatively, you can use the quite new DoOnceOnly function: 

function regionl WalksOnto () { 

if (Game . DoOnceOnly ( "glorianaasksf orhelp" ) ) { 
cGloriana.Say ("HELP, HELP!"); 
cGloriana.Say ("CAN SOMEONE PLEASE HELP!"); 

} 

} 



Q: HOW DO I CHANGE THE COLOUR OF A CHARACTER'S SPEECH FONT? 

A: If you want to keep one colour throughout then open up the characters tab (double click on the 
character in the treeview) and under Movement in the characters properties you'll find 
'SpeechColor', change that to a number to get the desired colour. 

In 8bit colour: 0 = black, 255 = white 

InlSbit colour: 0=black, 65535 = white 

If you want to change speech colour mid way, you can use the following in a room script (in Sbit): 
character's name>. SpeechColor = <colour number from 0 to 255> 
For example: 

cGuyBrush. SpeechColor = 14 

Will change the speech colour to yellow (in Sbit colour mode, and if the palette hasn't been 
changed). 



17 



Q: HOW DO I CHECK IF THE PLAYER IS HOLDING A NUMBER OF OBJECTS, SAY DIAMONDS? 

A: You use the player. InventoryQuantity: command: 

function diamondcheck ( ) 

{ 

if (player . InventoryQuantity [ idiamond . ID] ==1 0 ) ) 

{ 

Display ("You now have 10 Diamonds."); 

} 

{ 

Q: HOW DO I USE A GUI TEXT BOX IN MY GAME? I WANT TO MAKE IT SO THAT SOMETHING WILL HAPPEN WHEN THE 
PLAYER KEYS IN THE CORRECT PASSWORD. HOW DO I DO THIS? 

A: First of all you can use a GUI and put a text box in it. Make sure the GUI is closed when the game 
begins. Now when you want it open do this: 

gTextBox . Visible=true; 

on the textbox's activate section put this: 

if (txtbox . Text=="password" ) { 
//do something 

} 

else { 

//say password is wrong ecc 

} 

txtbox . Text=" ";/ /so that next time the GUI password opens player doesn't 
have to delete text. 



Q: HOW DO I CHANGE THE SPEECH ANIM SPEED? 

A: You would use the Character . SpeechAnimationDelay setting. 

Character . SpeechAnimationDelay = 4 // Set the delay between each frame of 
the speech anim to 4 



Q: I WOULD LIKE THE PLAYER TO BE ABLE TO THROW ANY OF HIS INVENTORY ITEMS OUT THE WINDOW. I WOULD LIKE 
A DISPLAY TO READ: "YOU THROW YOUR [ACTIVE INVENTORY ITEM] OUT THE WINDOW." 

A: player .Activelnventory. Name will return the name of the item the player is holding. All 
you need is this: 

DisplayC'You throw your %s out the window .", player . Activelnventory . Name) ; 
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Q: I AM TRYING TO CREATE A GAME AT THE MOMENT; THE PROBLEM IS UNDER 640 X 480 THE GUI IS NOT CORRECT. 

A: Here's one way to redo the GUI: 

1. Go to the GUI's from the treeview and select the glconBar. 

2. From the properties, change the height of the background for this GUI to 54 and the width 
to 640. 

3. You should now be able to see more of the icons. 

4. Select each icon in turn and change the properties, the height needs to be 54, the width 64 
and the Left of each icon needs to be multiples of 64 starting at 0; 0, 64, 128, 192, 256... to 
position them correctly. 



Q: IS IT POSSIBLE TO USE MONKEY ISLAND STYLE DIALOGUE WITH A 
HOTSPOT INSTEAD OR A CHARACTER, LIKE A PICTURE THAT'S PART OF THE 
BACKDROP? 



A: Sort of, but understand this is a workaround and may not work 
correctly in all situations. You need to place an invisible character 
on the hotspot and have it speak. The best way is to create a 
character and load in a single pixel picture as a character view 
and place it at the top edge of the hotspot area. In the picture to 
the right, the green dot on top of the old man's head is the 
'character' (cOldMan) while the old man is part of the backdrop 
and is covered by a hotspot (the green dot is large so you can see what I mean, normally this would 
be a single pixel so the player cannot see it). Now you can create a dialogue between the player and 
cOldMan. Remember to make the 1 pixel character non-clickable, just in case. 



Q: HOW CAN I SEPARATE A LINE OF SPEECH ONTO SEPARATE LINES? 

A: Say you have a speech line like this: 

cCharl.Say(" It was big... It was massive... it was humungous!") 

and you wanted it to look like this: 

It was big... 

It was massive... 

It was humungous! 

Then you'd place a square open bracket where you want to create a newline: 
cCharl.Say(" It was big... [It was massive. ..[it was humungous!") 
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Q: HOW CAN I CONTROL THE LENGTH OF TIME MY DIALOGUE STAYS ON SCREEN? 

A: The amount of time dialogue stays on screen is measured (by the engine) on how much text there 
is, shorter dialogue will show more briefly than longer dialogue, but there are a few ways you can 
control it. You can specify the minimum amount of time text thays on screen by the following 
command: 

Game . MinimumTextDisplayTimeMs = x //Number of milliseconds to stay on 
screen . 

Open up the script GlobalScript.asc and find the function game_start() and in place 

Game .MinimumTextDisplayTimeMs = 3000 // Text displayed for at least 3 
seconds 



You can also have pauses by using the Wait(x) command. Here's an example of a dialogue: 

@2 

/ /Who are you? 
BillGates: Who am I? 
BillGates: I'm Bill Gates. 
GuyBrush: What? 

BillGates: Bill Gates, the founder of Microsoft. 

GuyBrush: What are you doing here? I thought you were retired? 

BillGates: I didn't want to retire, they retired me. 

Wait (40); // Wait 1 second 
BillGates: It all started when they said they wanted to update the 
operating system. 

BillGates: They came to me with this buggy piece of software... 
BillGates: Memory leaks... 
BillGates: Incompatable drivers... 
BillGates: Obtrusive parental control... 

Wait (40); // Wait 1 second 
BillGates: I told them it was no good and to start again... 
BillGates: and before you could say 'Vista' they retired me. 
BillGates: Blindfolded me and took me to this island. 

BillGates: and now I spend each day seeing if they'll come back for me. 
GuyBrush: Don't worry, I'm sure they'll come back for you. 

Wait (40); // Wait one second 
BillGates: I hope not the sods. I have my cannon ready to sink the buggers 
if they come anywhere near here! 
Guybrush: Err., ok then. 
Return 



Q: Where can I define a variable so I can use it in numerous places? 

A: In the treeview there's an option called 'Global Variables', double click on it then right click on the 
area to the right to add a variable. 
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Q: I'm trying to get a character to move around at random, but I ONLY want him to move around 

WITHIN A CERTAIN AREA/SET OF COORDINATES. HOW WOULD I GO ABOUT DOING THIS? 

A: draw a Region that covers the area they're supposed to roam, then use: 

// room's rep_ex 
bool found; 
int x,y; 

if (! cGuy. Moving) { 
while ( ! found) { 

x = Random (Room. Width) ; 
y = Random (Room. Height) ; 

if (Region . GetAtRoomXY (x, y) == region [1]) found = true; 

} 

cGuy . Walk (x, y) ; 

} 

In theory, you could draw a few, say, 5x5 pixel sized dots instead of one filled area and the character 
will walk randomly between those "way points". 

Q: HOW CAN I INSERT FOOTSTEPS IN MY GAME WITH THE LAST AGS? I'VE GOT THE .MP3 SOUND AND I DON'T KNOW 
HOW TO INSERT WHEN THE CHARACTER MOVES. 

A: Open the normal view of the character, select the frame(s) showing the foot hitting the ground, 
then enter the sound's number in the sound field in the properties pane. 

Q: HOW CAN I HAVE A ROOM START OFF IN SEMI DARKNESS, HAVE THE PLAYER FLICK A LIGHT SWITCH AND HAVE THE 
ROOM LIGHT UP? 

A: Import the two backgrounds as room backgrounds. First the dark one, then the lit one (for the 
purposes of my explanation, it doesn't really matter). 

Add a "player enters screen before fadein" event to the room, then add the "interact with rope" 
event (by clicking the ellipses button in the event's field). 
Now open the room script. 
It should look like this: 

/ / room script 
function room_Load() 

{ 

} 

function oRope Interact () 

{ 

} 
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Add the following lines so it looks like this: 



// room script 
int light is on; 

function room Load ( ) { 

SetBackgroundFrame ( light is on); // set background to frame 0 (dark) 

or frame 1 (light) 

} 

function oRope Interact () { 

light is on = 1 - light is on; // toggle light 
SetBackgroundFrame (light_is_on) ; // update background 

} 

An alternative way to do it is use only the lit background, then put a semi-transparent, screen-sized 
black GUI on top. 

If you want to use that method, call the GUI e.g. gDarkness, then use this: 

// room script 
bool light is on; 

function room_Load() { 

gDarkness . Transparency = 40; // experiment with settings 20 to 80 

gDarkness .Visible = !light_is_on 

} 

function oRope_Interact ( ) { 

light is on = ! light is on; // toggle light 
gDarkness . Visible = !light_is_on 

} 

If you're changing the background frame, you might want to experiment with SetAmbientTint, 
Character.Tint, or Object.Tint to make the characters and objects on the screen get darker as well. 
Otherwise, you could just make them invisible if you don't want them to be seen at all when the 
lights are off. 

That would be done in: 



function oRope_Interact ( ) { 

light_is_on = 1 - light_is_on; // toggle light 
SetBackgroundFrame (light_is_on) ; // update background 

if (light_is_on==0) { 

//change the tints to black here 

} 

else { 

//remove tints here 

} 

} 
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Q: I WANT MY GUY TO LOOK UNDER A RUG AND FIND A RULER. BUT OF COURSE, I DON'T WANT HIM TO SAY, "OH 
LOOK A RULER" EVERY TIME HE LOOKS UNDER THE RUG. 

A: To use the DoOnceQ function, you just think of a text string you like which relates to the action 
you want. 

In your case, you can do something like this in the 'look at rug' action: 

if (Game. DoOnceOnly ("found ruler")) Display ("Oh look! A ruler!"); 
else DisplayC'I have looked under the rug before."); 

In this way, when you looked under the rug for the first time the first DisplayQ line is used, whereas 
when you looked under the rug for the second, third, ... times the Display() line in the 'else' part is 
used. 

Q: HOW DO YOU GIVE AN INVENTORY ITEM FROM ONE PLAYER CHARACTER TO ANOTHER? 

I tried with some simple code as: 

Function GiveObject (Target character){ 

Target characfer.Addlnventory (player.Activelnventory); 

player. Loselnventory (player.Activelnventory); 

} 

But I found I don't know how to define "Target Character". As soon as I find how to define the target 
character of the function (The alternative playable character who will receive the object) this should 
work. Then when coding in the "Use inventory on character" I should write "GiveObject();" and 
ready. 

A: You need to pass the character's name as the argument for the GiveObject function for that 
character's "Use inventory on character" interaction. So for each character you can give items to, 
you just have: 

function cCharl Uselnv(){ 
GiveObject (cCharl) ; 

} 

function cChar2_UseInv ( ) { 
GiveObject (cChar2) ; 

} 

etc . . . 

In case it is unclear how exactly the code's supposed to look: 

void GiveObj ect (Character*tc) { 

tc . Addlnventory (player .Active Inventory) ; 
player . Loselnventory (player .Active Inventory) ; 

} 
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